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SIRIUSWARE is dedicated to the development of quality utility 
programs designed to augment the capabilities of the Sinclair computer 
family (Timex/Sinclair 1000, ZX-81, and upgraded ZX-80). SIRIUSWARE 
utilities are 


@ Written in machine language, both for speed and for ease of 
use with user's own programs. 


® Provided on a cassette tape with a relocator program which 
places the utilities in any user-specified location. 


@ Mutually compatible; and in many cases, synergistic, so they 
can be combined for augmented capability. 


@ Easy to use, with simple user interfaces and comprehensive 
User's Manuals. 


SIRIUSWARE utilities are designed to be 


@ Used as program development tools (e.g. "cutting and pasting" 
BASIC code). 


@ Incorporated as an integral adjunct to the user's own programs 
(e.g. read/write tape data files). 


CURRENT UTILITIES 


FILE*SYS Cassette data tepe read/write . Sid 
FILE*BASIC Save/Merge/Erase BASIC (includes all $15 
the functions provided on FILE*SYS) 


FILE*VARS Save/Restore variables by name using $5 
tape cassette (requires either FILE*SYS 
or FILE*BASIC to provide tape read/write) 


V*S CAN Scan VAR area and list all variables - 0 
(free with purchase of FILE*VARS) 


BASIC*OLAY Overlay BASIC code; Copy BASIC code into $10 
RAM storage area 


LOGI C* Prevides true logical operations for $ 5 
control operations (AND, OR, NOT, NAND, 
NOR, XOR) 
(LOGIC* available in Jan 83) 
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FILE*SYS is a utility package to read and write cassette tape data files. The 
programs in FILE*SYS provide the capability to write data to tape without saving 
the entire program, and to read data from tape without overwriting the current 
program. Use of these utilities thus provides faster storage and retrieval of data 
than is possible using SAVE and LOAD, and provides greater programming flexibility 
in data handling. In addition, error checking is provided to insure data integrity. 

The package comes to you on a cassette tape in the standard format for the 
ZX-81, Timex/Sinclair 1000, or ZX-80 (or Microace) with the corrected 8K ROM. The 
utilities are written in machine language (ML). LOADing the tape results in 
automatic initiation of a relocator program which asks you where the utilities 
should be stored, then puts the utilities where you specify. The utilities will 
run on a 2K machine; however, they will be more useful if you have more RAM. 

A comprehensive user's manual is provided, including examples and instructions 
for use with 2K, 16K, and 64K RAM. 


FEATURES 


@ Writes any number of bytes from any area of memory onto tape. 

@ Reads any number of bytes into any area of memory from tape. 
Compatible with Timex/Sinclair tapes, i.e., uses same bit encoding and tape file 
naming conventions. 

Reads normal SAVEd tapes as data. 

Reads unnamed tape files (e.g., Sinclair 4K ROM SAVEd tapes). 
Provides error detection via 16-bit checksum. 

Easy to use with two entry points, READ and WRITE. 

Easy to understand read and write options provide flexibility. 
Error returns provide potential for user programmed error recovery. 
Can be used in immediate mode or under program control. 

Only 417 bytes of memory required. 

Complete user documentation. 


USER INTERFACE 


Standard USR call followed by the file definition contained in a REM statement. 
The file definition has four parts: addr len type name. "Addr" is the memory 
address to read data to (or write data from), "len" is the number of bytes to be 
read (or written), "type" specifies the read (or write) option, and "name" is the 
the name of the tape file. 


Example: 
100 REM READ EXAMPLE 200 REM WRITE EXAMPLE 
105 PRINT USR 28160 205 PRINT USR 28301 
110 REM 29000 500 1 DFILE 210 REM 29000 500 1 DFILE 


Here 28160 is the entry address for the READ program. Up to 500 bytes from the 
data tape named DFILE will be read into memory and stored in memory addresses from 
29000 through 29499. The WRITE program, with entry address 28301, generates a data 
tape named DFILE, containing the 500 bytes from memory addresses 29000 through 
29499. 
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FILE*BASIC 


FILE*BASIC is a utility package which is an enhancement of FILE*SYS. It 
provides all the capabilities of FILE*SYS plus additional capabilities which 
provide greater user flexibility in editing BASIC programs. FILE*BASIC provides 
the following special user capabilities. One, a simple user interface for saving 
all or part of your BASIC program on a data tape file. Two, the capability to 
merge several BASIC programs and subroutines into one BASIC program. Three, the 
capability to erase blocks of contiguous BASIC lines with only a few keystrokes. 
Four, the capability to ascertain the memory address of any BASIC line. 

The FILE*BASIC package provides the user with an extremely useful software tool 
which can be used to develop library tape files of useful BASIC subroutines and 
program segments, and the capability to combine any number of these into one BASIC 
program. It is possible to READ and MERGE BASIC programs which have been written 
to tape with the standard SAVE command. This provides the potential for recovering 
programs which the system refuses to LOAD. 

The package comes to you on a cassette tape in the standard format for the 
ZX-81, Timex/Sinclair 1000, or ZX-80 (or Microace) with the corrected 8K ROM. The 
utilities are written in machine language (ML). LOADing the tape results in 
automatic initiation of a relocator program which puts the utilities where you 
specify. The utilities will not run on a 2K machine. 

A comprehensive user's manual is provided, including examples and instructions 
for use with 16K and 64K RAM. 


FEATURES 


e@ All the features of FILE*SYS. 

@ Save BASIC code from cursor-marked location to end of BASIC (up to D_FILE). 
Merge BASIC code from memory read buffer (loaded via READ) into existing BASIC 
at cursor-marked location. 

@ Merge in immediate mode or under program control. 

@ Erase cursor-specified block of BASIC lines. 

@ Learn the address of cursor-marked BASIC line. 

@ Simple user interface via cursor and USR calls. 
e 
e 


Only 564 bytes of memory required. 
Complete user documentation. 


USER INTERFACE 


The FILE*BASIC editing utilities require only that the user place the cursor on ° 
the BASIC line of interest and then evoke an immediate mode USR call (e.g., PRINT 
USR nnnnn). The user interface for READ and WRITE is that described for FILE*SYS. 
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FILE*VARS 


FILE*VARS is a utility package for saving and restoring strings and arrays. It 
provides a simple user interface for writing to tape any named string or array, making 
use of the tape write capability of FILE*SYS or FILE*BASIC. In addition, once a string 
or array has been read from the tape file, FILE*VARS provides a simple procedure for 
restoring that variable in the system VARS area. 

The use of FILE*VARS requires that either FILE*SYS or FILE*BASIC be available in RAM. 

The package comes to you on a Cassette tape in the standard format for the ZX-81, 
Timex/Sinclair-1000, or ZX-80 (or Microace) with the corrected 8K ROM. The utility is 
written in machine language (ML). LOADing the tape results in automatic initiation of a 
relocator program which puts the utilities where you specify. The package (with 
FILE*SYS or FILE*BASIC) requires greater than 2K RAM. 

A comprehensive user's manual is provided with instructions for use. 


FEATURES 


e Save any string or array by name reference. 

e Alternative entry points for even simpler default-save of variable P or P$. 
e@ Simple USR call to move variable from read buffer to VARS area. 

Error detection ensures data integrity. 

Uses 140 bytes of memory (in addition to FILE*SYS or FILE*BASIC). 

Fast. 

Easy to understand user documentation. 


USER INTERFACE 


Save variable by name requires USR call, followed by the variable name in a REM 
statement. Alternative entries (USR calls to different addresses) provided to save 
variable P (array) or P$ (string or string array) as default names with no REM statement 
required. Restore variable requires simply a USR call after the appropriate tape data 
file has been read using the READ program from FILE*SYS or FILE*BASIC. 


*** ADDED BONUS *** 


The utility V*SCAN is included on the FILE*VARS tape. V*SCAN provides the 
capability to scan the VARS area and list all defined variables, including their 
attributes, such as array dimensions and string lengths. V*SCAN can also be used to 
determine the memory location of any specific variable. 
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BASIC*OLAY 


BASIC*OLAY is a utility package which provides in-RAM transfer of BASIC code. It 
contains two programs to move BASIC code into a user-defined buffer outside of the 
designated BASIC area, and to move BASIC code from the buffer into the BASIC area. 
Overlaying, implemented with the utility package, permits the segmenting of large 
programs and overlaying code segments as the execution proceeds. It provides the 
capability of dynamic (run-time) program-controlled program modification. With the 
package, extremely large BASIC programs can be run. It also provides the capability of 
combining several BASIC programs. Only about 8K RAM is required for the utility to be 
useful; however, its real value is realized when greater than 16K RAM is available. It 
allows the use of all available 64K RAM for the storage of BASIC programs. By combining 
BASIC*OLAY with FILE*BASIC, even more flexibility is available, including overlaying 
with BASIC code read from tape. 

The package comes to you on a cassette tape in the standard format for the ZX-81, 
Timex/Sinclair-1000, or ZX-80 (or Microace) with the corrected 8K ROM. The utilities 
are written in machine language (ML). LOADing the tape results in automatic initiation 
of a relocator program which puts the utilities where you specify. 

A comprehensive user's manual is provided, including examples of use. 


FEATURES 


© Copies any number of BASIC lines into user-specified buffer. 

e Copies any number of BASIC lines from user-specified buffer into a BASIC program. 

e Any number of user-defined BASIC program areas can be overlayed any number of times. 
© Allows multiple buffers; multiple overlay areas. 

Can be combined with FILE*BASIC for overlaying BASIC code from cassette tape. 

Simple user interface. 

Fast. 

Only 172 bytes of memory used by utility programs. 

Easy to understand user documentation. 


USER INTERFACE 


Two easy to use USR called programs, COPY and OVERLAY, are provided. COPY moves 
BASIC lines from the BASIC program to the buffer. COPY is used in program development 
and loading, as well as during program execution. OVERLAY is used during program 
execution to provide the dynamic modification of the program. OVERLAY removes the BASIC 
code in the designated overlay area and replaces it with the code from the buffer. The 
buffer location is specified in a REM statement immediately following the USR call to 
COPY or OVERLAY. The BASIC code area to be copied out, or overlayed into, is marked at 
the beginning and end by the special statements REM $$$. For example, the code sequence: 

100 RAND USR OVERLAY 

105 REM 36000 

500 REM $$$ 

1000 REM $$$ 
will place, between lines 500 and 1000, the BASIC code which has been stored in the 
buffer at 36000. The variable OVERLAY has here been defined as the entry point address 
to OVERLAY. The same sequence, but with a USR call to COPY instead of OVERLAY, would 
copy all BASIC code, located between statements 500 and 1000, into the buffer at 36000. 


